home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / migrate.man < prev    next >
Encoding:
Text File  |  1991-04-03  |  6.5 KB  |  201 lines
  1.  
  2.  
  3.  
  4. MIGRATE                   User Commands                   MIGRATE
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      migrate - Migrate a command to another machine
  12.  
  13. SSYYNNOOPPSSIISS
  14.      mmiiggrraattee [--BBbbvvllDD] [[--hh _h_o_s_t] | [--HH  _h_o_s_t_I_D]]  [--pp  _p_r_o_c_e_s_s_I_D]
  15.      [(--EE _c_m_d arg0 | _c_m_d) _a_r_g_s ...]
  16.  
  17. _________________________________________________________________
  18.  
  19. IINNTTRROODDUUCCTTIIOONN
  20.      This command is used to execute commands remotely using  the
  21.      Sprite  process  migration facility.  It may be used to exe-
  22.      cute commands on a particular machine or to select from idle
  23.      machines;  and  it  may  execute  a command specified by the
  24.      arguments to the mmiiggrraattee program, or an interactive shell.
  25.  
  26. SSEELLEECCTTIINNGG AA HHOOSSTT
  27.      --BB   The --BB specifies that the host should  be  selected  at
  28.           ``background''  priority,  rather  than at the priority
  29.           used for other tasks such as compilations.
  30.  
  31.      --hh
  32.  
  33.      --HH   By default, a host is  selected  from  among  the  idle
  34.           hosts  available  on  the  local network.  This host is
  35.           then marked as being in use for  the  duration  of  the
  36.           command being executed; the host will not be chosen for
  37.           remote execution of other processes  in  the  meantime.
  38.           If  a host is specified with the --hh or --HH options, then
  39.           the ``in-use'' flag is bypassed; this  is  useful  when
  40.           invoking mmiiggrraattee as a ``remote login'' facility to exe-
  41.           cute commands directly on another host.   The  --hh  flag
  42.           specifies  a host by name, and the --HH flag specifies it
  43.           by spriteID (thereby bypassing the host database lookup
  44.           to convert from name to internal numeric identifier).
  45.  
  46.      --ll   If no host is specified and no idle host is  available,
  47.           the  command  is  not  executed unless the --ll option is
  48.           specified,  in  which  case  the  command  is  executed
  49.           locally.    The  ``--ll''  option  similiarly affects the
  50.           disposition of the command if migrating  to  the  other
  51.           host fails.
  52.  
  53. EEXXEECCUUTTIINNGG AA CCOOMMMMAANNDD
  54.      To execute a single command remotely,  the  command  may  be
  55.      specified by placing the command and its arguments after any
  56.      options to mmiiggrraattee.  If no command is specified, an interac-
  57.      tive shell is created.  If the SSHHEELLLL environment variable is
  58.      present, that shell is invoked, otherwise  ccsshh  is  invoked.
  59.      In any case, the exit status from the subprocess is returned
  60.      by mmiiggrraattee.
  61.  
  62.  
  63.  
  64.  
  65. Sprite v.1.0         Printed:  April 3, 1991                    1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. MIGRATE                   User Commands                   MIGRATE
  73.  
  74.  
  75.  
  76.      --EE  _c_o_m_m_a_n_d
  77.           In some circumstances, programs  may  be  invoked  with
  78.           aarrggvv[[00]]  different  from  the  name of the command.  In
  79.           this case, the --EE option may be  used  to  specify  the
  80.           name of a file to execute, and the first argument after
  81.           the option list specifies the value of aarrggvv[[00]].    Oth-
  82.           erwise,  aarrggvv[[00]] is set to the name of the command that
  83.           is invoked.
  84.  
  85. MMIIGGRRAATTIINNGG AA CCUURRRREENNTT PPRROOCCEESSSS
  86.      --pp   To migrate a process that is already executing,  invoke
  87.           mmiiggrraattee  with  the  --pp option, giving the process ID of
  88.           the process to migrate (in hex notation).  Each process
  89.           must  be  migrated  individually,  in  separate runs of
  90.           mmiiggrraattee.
  91.  
  92. OOTTHHEERR OOPPTTIIOONNSS
  93.      --bb   The --bb option may be used to enter ``background mode'',
  94.           in which mmiiggrraattee executes a command and returns immedi-
  95.           ately, printing the process identifier of the  migrated
  96.           child.  Thus,
  97.                               mmiiggrraattee xxyyzzzzyy&&
  98.           is different from
  99.                              mmiiggrraattee --bb xxyyzzzzyy.
  100.           The process identifier for the former case  is  printed
  101.           by  the  shell,  and it corresponds to the mmiiggrraattee pro-
  102.           cess; while the process identifier in the  latter  case
  103.           corresponds  to  the  migrated  child  itself.   In the
  104.           former case, normal ccsshh job  control  may  be  used  to
  105.           foreground  and  background  the migrated child, but in
  106.           the latter case, the process is not controlled by ccsshh.
  107.  
  108.      --vv   The --vv option may be used to enter ``verbose mode'', in
  109.           which  case the host selected for migration is printed,
  110.           or a message that no host could be selected is  printed
  111.           if  the  command  is  executed  locally  due  to the --ll
  112.           option.
  113.  
  114.      --DD   The --DD option  enables  ``debug  mode'',  which  causes
  115.           various  debugging statements to be printed as the pro-
  116.           gram executes.
  117.  
  118. SSEEEE AALLSSOO
  119.      migrate, db, xload, pmake, loadavg, csh, ps
  120.  
  121. FFIILLEESS
  122.      //sspprriittee//aaddmmiinn//ddaattaa//mmiiggIInnffoo - the global  migration  database
  123.      file.
  124.  
  125. KKEEYYWWOORRDDSS
  126.      process migration, load average, uptime,  idle  time,  data-
  127.      base, remote execution
  128.  
  129.  
  130.  
  131. Sprite v.1.0         Printed:  April 3, 1991                    2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. MIGRATE                   User Commands                   MIGRATE
  139.  
  140.  
  141.  
  142. BBUUGGSS
  143.      If a process that is executing remotely is evicted when that
  144.      machine is no longer available, the process will continue to
  145.      execute locally.  This is nearly completely  transparent  to
  146.      the  user  (ppss  --mm  will  no  longer  show  the  process  as
  147.      migrated).  Even if the host were not selected as an  ``idle
  148.      host'',  the  migrated  process  can be evicted if the other
  149.      host goes from being available to being unavailable.
  150.  
  151.      If another host is selected at random to migrate  a  process
  152.      that  is already running, when that process exits the remote
  153.      host, the remote host will remain flagged as ``in use''  for
  154.      a short period of time.  This is because the mmiiggrraattee process
  155.      cannot conveniently wait for a process that isn't its child.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0         Printed:  April 3, 1991                    3
  198.  
  199.  
  200.  
  201.